Pulfrich para Mac
=================
Desarrollado por TRAUT SpA · https://traut.cl
Pulfrich es el nombre nuevo de TRAUT Georreferenciación: las licencias, los proyectos y los
trabajos hechos con las versiones anteriores siguen sirviendo.

Georreferenciación de fotos de drones: escribe en cada foto la posición de su centro de cámara.
Con drones con módulo RTK, por PPK con una base GNSS o con el RTK a bordo; con drones sin RTK,
orientando las fotos con puntos de control medidos en terreno, sin base. Con PPK o RTK, los
puntos de control también ajustan la posición de las fotos y miden el error real.
Es el mismo programa que el de Windows, con los mismos pasos, resultados y licencias.
El ortomosaico y los modelos se agregan con el módulo Ortomosaico, que se instala aparte.

INSTALACIÓN
  El instalador es de UN SOLO USO: queda anotado en el Mac y no vuelve a instalar en él (su carpeta no se borra).
  Para reinstalar o instalar en otro Mac, pida a TRAUT SpA un instalador nuevo.
  1. Haga doble clic en el archivo .tar.gz: se abre la carpeta «Pulfrich …».
  2. Abra la Terminal (Aplicaciones › Utilidades › Terminal), escriba  bash  y un espacio,
     arrastre a la ventana el archivo «Instalar.command» de esa carpeta y pulse Enter.
     (También se puede hacer doble clic en «Instalar.command»; como el instalador no está
     firmado por Apple, el Mac lo bloquea la primera vez: abra Configuración del Sistema ›
     Privacidad y seguridad y pulse «Abrir igualmente».)
  3. El instalador reconoce si el Mac tiene procesador Apple (M1, M2, M3, M4…) o Intel, copia el
     programa que corresponde en Aplicaciones y lo deja listo para abrir.
  4. Pregunta si instalar el motor fotogramétrico (ver REQUISITOS). Para PPK y RTK a bordo no se
     necesita.
  5. Abra «Pulfrich» desde Aplicaciones o Launchpad, pulse «Licencia» (arriba a
     la derecha) y envíe a TRAUT SpA el código de ese Mac (TRG-…) con el nombre y el RUT del
     cliente. Cargue el archivo de licencia .tgeo que le devuelvan en esa misma ventana. Sin
     licencia funciona 3 procesamientos de prueba.

QUÉ HACE
  1. Método: la carpeta del trabajo y cómo se obtiene la posición de las fotos: PPK con una
     base GNSS, RTK a bordo o sin RTK con puntos de control. En la carpeta del trabajo deje un
     solo trabajo: los datos de la base (RINEX .25o/.25p, .T02, .GNS…), la carpeta de las fotos
     del vuelo y, si se usan, la lista de puntos de control. Los resultados quedan en
     «Resultado Pulfrich» dentro de ella.
  2. Base GNSS (solo PPK): estático .GNS, RINEX 2/3 de cualquier receptor, RINEX comprimido de
     estaciones CORS (.crx, .yyd, .gz, .Z), crudos de receptor (RTCM 3, UBX, SBF, OEM binario, GREIS, RT17,
     BINEX, STQ, BINR) y archivos .T02, que el propio programa lee. Otros formatos cerrados deben
     exportarse a RINEX desde el receptor o con el software del fabricante.
  3. Vuelo: la carpeta del vuelo (con RTK: Timestamp.MRK, PPKRAW.bin y fotos; sin RTK: las fotos
     JPG con su GPS).
  4. Puntos de control: lista del rover y marcado en las fotos, guiado si se alinean las fotos.
     En la ventana de marcado: doble clic marca, Espacio acepta la propuesta, clic derecho (o con
     dos dedos en el trackpad) quita la marca, la rueda o el pellizco acercan y arrastrar mueve.
     Con las fotos alineadas (y después de orientar, con las cámaras finales), cada marca muestra
     su error en píxeles y en centímetros frente a σ, el error medio de todas las marcas: verde
     hasta 1σ, amarillo hasta 2σ, rojo sobre 2σ, separado en fotos nadir y oblicuas. Una marca se
     puede dejar fuera sin borrarla (tecla U; también todas las que pasan de 2σ o las de fotos
     oblicuas) y volver a usarla. La ventana de marcado no bloquea el programa: el mapa y las
     fotos siguen a la vista.
  5. Cálculo: con PPK, trayectoria con RTKLIB y posición del centro de cámara de cada foto; sin
     RTK, orientación de las fotos con los puntos de control, con el motor fotogramétrico.
  6. Revisión y exportación: controles del vuelo, CSV por foto, trayectoria, informe y copias de
     las fotos con la posición nueva escrita en el EXIF y XMP (los originales no se modifican).
     Con puntos de control: el error de cada punto y de cada marca (en píxeles, en σ y en
     centímetros), y en el mapa un anillo de color en cada foto con marcas.

MAPA Y FOTOS PARA REVISAR
  La foto elegida se ve en su panel en tamaño real: rueda o pellizco = zoom, arrastrar = mover,
  doble clic = tamaño real o la foto entera; el zoom se mantiene al pasar de foto, con las
  marcas de los puntos y su error encima. El panel se agranda arrastrando sus bordes, y su botón
  «Ampliar» lo lleva a todo el lado derecho (otra vez para volver).
  El mapa (con la vista 3D) se puede ver en una ventana aparte, para maximizarlo o llevarlo a
  otro monitor (botón del mapa o menú Ver; Control+Comando+F: pantalla completa).

CONVERTIR A RINEX
  Pestaña «Convertir a RINEX»: convierte por lotes bases de cualquier marca que el programa lee
  (RINEX 2/3 también comprimidos, .GNS, .T02 y crudos de receptor) a RINEX con su navegación, con
  el marcador, la antena y la altura que se indiquen. Acepta archivos o una carpeta entera.
  Nunca escribe sobre el archivo original ni sobre un RINEX del receptor.

LICENCIA
  Igual que en Windows: 3 procesamientos de prueba y después la licencia anual .tgeo, para ese
  Mac, que envía TRAUT SpA a partir del código del equipo (botón «Licencia»). El código de un
  Mac sale de su placa: no cambia al reinstalar el sistema.

REQUISITOS
  macOS 13 (Ventura) o posterior, con procesador Apple o Intel. .NET 10, la calibración de
  antenas, RTKLIB (PPK y lectura de crudos) y crx2rnx (RINEX Hatanaka) van incluidos,
  compilados para cada procesador: no hace falta instalar otros programas para PPK y RTK.
  Motor fotogramétrico (ODM 3.6.2): lo usan la orientación sin RTK y el módulo Ortomosaico. El
  instalador lo puede instalar en la carpeta ODM de su usuario (unos 3 GB, entre 30 y 90
  minutos, con internet): instala Homebrew (administrador de paquetes gratuito para Mac), las
  herramientas de Apple y el motor. Para instalarlo después a mano, en la Terminal:
      git clone --depth 1 --branch v3.6.2 https://github.com/OpenDroneMap/ODM.git ~/ODM
      cd ~/ODM && bash configure_macos.sh install
  Para vuelos sin RTK se recomiendan 16 GB de memoria o más.
  Los archivos .T00, .T01 y .T04 con variantes que el programa todavía no lee y los .GNS con
  otro formato interno deben llevarse antes a RINEX: sus conversores solo existen para Windows.
  El programa trabaja sin internet y no descarga conversores ni otros archivos mientras se usa.
  El mapa muestra el vuelo, la base, los puntos y el ortomosaico, MDS y MDT hechos en el equipo.
  Si el equipo tiene internet, debajo aparece además una imagen satelital gratuita (unos 10 m
  por píxel, de 2016); lo ya visto queda guardado y se ve también sin conexión.

DÓNDE QUEDA CADA COSA
  Programa:   Aplicaciones › Pulfrich
  Licencia y prueba:  ~/Library/Application Support/TRAUT/Fotogrametria
  Motor fotogramétrico:  ~/ODM
  Para desinstalar, arrastre el programa de Aplicaciones a la Papelera (la licencia queda
  guardada para una reinstalación).

RESULTADOS (en «Resultado Pulfrich», dentro de la carpeta del trabajo; un trabajo hecho con una
versión anterior sigue en su carpeta «Resultado TRAUT»)
  01_BASE           RINEX de la base corregido (antena, altura, marcador) y su navegación
  02_PPK            RINEX del dron, configuración de RTKLIB y trayectoria .pos
  03_EXPORTACIONES  CSV de fotos, CSV de trayectoria e informe; con puntos, posición ajustada
                    de las fotos y error de cada punto
  04_FOTOS_GEORREFERENCIADAS  copias de las fotos con la posición nueva
  05_PUNTOS_CONTROL puntos del rover, sus marcas en las fotos, gcp_list.txt y, con PPK o RTK,
                    geo.txt (posición calculada de cada foto para el motor)

COMPONENTES DE TERCEROS
  RTKLIB 2.4.3 b34 (T. Takasu), licencia BSD-2: ver rtklib/LICENSE.txt dentro del programa.
  Compilado para Mac sin modificar, con las opciones de sus makefiles oficiales.
  RNXCMP 4.2.0 (crx2rnx), del Geospatial Information Authority of Japan: ver
  rtklib/LICENSE_RNXCMP.txt. Referencia: Hatanaka, Y. (2008), A Compression Format and Tools for
  GNSS Observation Data, Bulletin of the Geospatial Information Authority of Japan, 55, 21-30.
  Calibración de antenas: igs20.atx del International GNSS Service (IGS, datos públicos), más
  calibraciones de antenas que no están en ese archivo (antenas/traut_antenas.atx).
  ODM 3.6.2 (OpenDroneMap), licencia AGPL-3.0: motor fotogramétrico, instalado sin modificar
  desde su código oficial (https://github.com/OpenDroneMap/ODM, versión v3.6.2) y usado como
  programa aparte. Su licencia está en ~/ODM/LICENSE.
  Avalonia 11.3 (ventanas del programa), SkiaSharp y HarfBuzzSharp (dibujo y texto), licencia
  MIT; van dentro del programa.
  Imagen satelital del mapa (solo con internet): EOxCloudless https://cloudless.eox.at by EOX IT
  Services GmbH (Contains modified Copernicus Sentinel data 2016), licencia Creative Commons
  Atribución 4.0 (https://creativecommons.org/licenses/by/4.0/). No viene con el programa: se ve
  desde el servicio de EOX y lo visto queda guardado en el equipo.
